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Preface 


About the Documentation Set 


The Microtec Research ASM68K package consists of the following: the ASM68K 
Assembler, LNK68K Linker, and LIB68K Object Module Librarian. The 
documentation set describing the Microtec Research ASM68K software consists of 
this Installation Guide, a User’ s Guide, and a Reference Manual. 


About this Guide 


The Installation Guide contains host computer and operating system- 
specific instructions on how to install the ASM68K package. 


The User’ s Guide contains host computer and operating system-specific 
syntax for invoking the macro string preprocessor, assembler, linker, 
object module librarian, and conversion programs. 


The Reference Manual contains complete descriptions of the macro 
string preprocessor, assembler syntax and directives, linker commands, 
and librarian commands. Sample program listings are used as examples 
for the assembler, linker, and object module librarian. Error and warning 
messages are described. 


This Installation Guide describes how to install the Microtec Research ASM68K 
assembler package on the following host computers and operating systems: 


Digital Equipment VAX computers using VMS 

Hewlett-Packard HP 9000 Series 300 computers using HP-UX 
IBM-PC/AT and compatible computers using PC-DOS or MS-DOS 
80386 computers using SCO UNIX System V/386 


If your host is supported by Flexible Licensing, refer to the Flexible Licensing 
documentation for installation instructions and ignore installation instructions in 
this guide. The following hosts are supported by Flexible Licensing: 
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Apollo computers running DOMAIN/OS 
DECstation computers running ULTRIX 

HP 9000 Series 700 computers running HP-UX 
HP 9000 Series 800 computers running HP-UX 
Sun-3 computers running SunOS 

Sun-4 computers running SunOS 


Notational Conventions Preface 


For all other hosts, refer to the Installation Guide chapter that pertains to your host 
computer and operating system, and disregard the others. 


The ASM68K Assembler and related programs are included with the MCC68K 
Compiler and XRAY68K Debugger software and will be automatically installed 
when you install either of those packages. It will then be unnecessary to follow the 
installation procedures described in this guide. If you have purchased the MCC68K 
Compiler, disregard, this guide and refer to the Microtec Research MCC68K 
Installation Guide. If you have purchased the XRA Y68K Debugger, disregard this 
guide and refer to the Microtec Research XRAY68K Installation Guide. 


Notational Conventions 


The Microtec Research ASM68K Installation Guide uses the following notational 
conventions shown in Table P-1. 


Table P-1. Notatlona! Conventions 
Meaning 


Punctuation Punctuation such as commas (,) and colons (:) 
must be entered as shown. 


typewriter font Represents user input in interactive examples. 


punctuation Punctuation such as commas (,) and colons (:) 
must be entered as shown. 
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VAX / VMS Installation 1 


This chapter describes how to install the Microtec Research ASM68K Assembler, 
Linker, and Librarian on a VAX host computer using the VMS operating system. 


The operating system prompt used in the directions is a dollar sign ($). Your system 
may be configured with a different prompt. 


Distribution Format 
The Microtec Research ASM68K package for VAX/VMS is available on: 


¢ 9-track magnetic tape (1600 bpi) in BACKUP format 
¢ TKS50O cartridge tape in BACKUP format 


Installation Procedure 


The ASM68K assembler package for VMS is distributed on either magnetic tape, 
or cartridge tape. The first step in installing the programs is to copy the files from 

C the tape onto the host computer system’s working disk. Once the files are copied, 
you should execute the installation command procedure to complete the 
installation. 


To install the ASM68K assembler package, follow the listed steps: 


1. Log in to the system installation account, SYSTEM. You must have the 
privileges of a system manager in order to log into this account. 


2. Set the default directory to SYSSUPDATE by entering: 
§ SET DEFAULT SYSSUPDATE: 


The SYS$UPDATE directory is used during the installation procedure as a 
temporary directory. Files are read into the SYS$UPDATE directory and 
| then moved to other directories. All files created in this directory are 
automatically removed after the installation process. 


3. Physically mount the distribution tape on an appropriate drive. Verify that 
the tape is write-protected by setting the write protection switch in the safe 
position (cartridge tape) or by removing the write-enable ring if one is on 
the tape (9-track tape). 


Fe. 
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4. If the tape drive on your system has a density switch on it, set it for the 
density indicated on the distribution tape. 


The name of the tape drive can vary from one computer system to another. 
See your system administrator for the tape device name that is correct for 
you. Table 1-1 shows some common devices and their corresponding 
mnemonic names. 


Table 1-1. Device Types 


Device Type Mnemonic 


TU78 MF cn: 
TE16, TU16, TU77 MTcn: 
TS11, TSV05, TU80 


TK50 


In the mnemonics shown, c refers to the controller (usually A), and refers 
to the unit number of the drive (usually 0). 


Note 


These instructions use MTAO as a sample device name. Use 
the appropriate tape drive designation for your system in 
place of MTAOQ:. 


5. Logically mount the tape by entering: 
$ ALLocATE MTAO: 
$ MOUNT/FOREIGN MTAO: 


6. Create an empty directory and move to it, or change your current directory 
to an existing empty directory. This directory is your distribution directory. 


$ CREATE/DIRECTORY | .distribution_directory} 
$ SET DEFAULT ( .distribution_directory} 


7. Copy the files from the tape to your distribution_directory by entering: 
$ BackuP MTAQ:*.* *.*; 


Warning 


Files with duplicate file names will be overwritten. Refer to 


your Release Notes for information on the files provided with 
this distribution and the default installation directories. 
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VAX / VMS installation - Getting Started 


8. Dismount the tape by entering: 


$ pismounT MTA0: 
$ DEALLOCATE MTAQ: 


9. Run the installation procedure command file by entering: 
$ @MRIINSTAL 


10. Log out and log back in to activate the CLI tables, which are updated by the 
installation command file. Other users logged in during this installation 
must also log out and log back in before using the executable program 
images included on the ASM68K distribution. 


You have now completed the ASM68K installation. 


Getting Started 


After installation, see the Microtec Research ASMO8K User's Guide for 
information on how to invoke ASM68K. 
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HP / HP-UX Installation 2 


This chapter describes how to install the Microtec Research ASM68K Assembler, 
Linker, and Librarian on a Hewlett-Packard HP 9000 Series 300 computer using the 
HP-UX operating system. 


The operating system prompt used in the directions is a percent sign (%). Your 
system may be configured with a different prompt. 


Distribution Format 


The ASM68K assembler package for the HP-UX operating system is distributed as 
a UNIX tar file on a cartridge tape. 


Installation Procedure 


To install the ASM68K files, complete the following steps: 


1. 
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Log in to an account that has super-user privileges. Since ASM68K files 
will be copied to directories requiring root write permission, you must have 
super-user privileges to complete the installation. 


Physically mount the cartridge tape on an appropriate drive. Verify that the 
tape is write-protected by setting the write protection switch in the safe 
position. 
Create an empty directory and move to it, or change your current directory 
to an existing directory. This directory is your distribution directory. 

% mkdix distribution_directory 

% cd distribution_directory 
Read the tape using the following command: 


% tar -xtvf device 


where device is the device name for the cartridge tape drive (e.g., /dev/rst0). 
The names of the files are displayed on your terminal as they are read into 
the distribution_directory. 
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5. Invoke the installation script that moves ASM68K files to various 
directories by entering: 


% sh mrié68kinst 


Warning 


Files with duplicate file names will be overwritten. Refer to 
your Release Notes for information on the files provided with 
this distribution and the default installation directories. 


This command invokes a68kinst, which installs the ASM68K files. 


6. Add /usr/mri/bin to your path variable if it is not already there. If you are 
using the C shell (csh), enter: 
%& set path=(S$path /usx/mri/bin) 
If you are using the Bourne shell (sh), enter: 
% PATH="SPATH:/usr/mri/bin" 
7. Change your .login (csh) or .profile (sh) file to include /usr/mri/bin in 
your path definition. 


8. If you are using the C shell (csh), you must make executable files available 
from the current directory by entering: 


% rehash 


You have now completed the ASM68K installation. 


Getting Started 


After installation, see the Microtec Research ASM68K User’s Guide for 
information on how to invoke ASM68K. 
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IBM-PC / DOS Installation 3 


This chapter describes how to install the Microtec Research ASM68K Assembler, 
Linker, and Librarian on an IBM-PC/AT or compatible computer with 640 K bytes 
RAM using the MS-DOS operating system (version 3.0 or newer) or the PC-DOS 
operating system. 

The operating system prompt used in the directions is C>. Your system may be 
configured with a different prompt. 


Note 


Before installation, make backup copies of the diskettes 
using the DOS DISKCOPY command. ~ 


Distribution Format 


( \ The ASM68K assembler package for DOS is distributed on 5.25 inch (360K or 
nt 1,2MB) or 3.5 inch (720K or 1.4MB) floppy diskettes. 


Installation Procedure 


To install the ASM68K files, complete the following steps: 
1. Boot DOS. 
2. Insert the diskette labeled 1 of n into drive A and enter: 
C> a:install 


This command creates the distribution directory and copies the distribution 
files into it. Instructions will appear on your display screen. You will be 
prompted for: 


¢ target hard drive (default: C) 
¢ distribution directory (default: \ASM68K) 
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Installation Procedure : IBM-PC / DOS Installation 


You can enter CTRL-C (press both keys simultaneously) at any prompt to 
abort the installation. 


Warning 


If the distribution directory already exists, the installation 
program displays a message warning you that ail the files 
in the distribution directory will be erased. You can select 
a different distribution directory at this time. 


3. Insert the other diskettes into drive A as prompted. 


4. Modify your current search path to include the distribution directory. Use 
the DOS PATH command to determine the current path setting: 


c> PATH 


Then, append the distribution directory to your current path using the 
PATH command. For example, if your current path is c: \bin;\dir1, you 
would append \ASM68K to your current path by typing: 


c> PATH ¢:\bin;\diri; \ASM68K 
5. Edit thé AUTOEXEC.BAT file to include the updated path, 
6. Edit the CONFIG.SYS file to contain the lines: 


FILES = 11 
BUFFERS = 11 


Note 


These are the minimum values required; other applications 
may require larger values. You may want to increase these 


values if many include files are used. Care should be 
exercised when increasing these values, as file and buffer 
parameters reduce available memory. 


7 7. Always reboot your system after modifying the CONFIG.SYS file so that 
DOS will use your new values. 


You have now completed the ASM68K installation. 
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IBM-PC / DOS Installation Getting Started 


Getting Started 


After installation, see the Microtec Research ASMO68K User's Guide for 
information on how to invoke ASM68K. 
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SCO UNIX System V/386 Installation 4 


This chapter describes how to instal] the Microtec Research ASM68K Assembler, 
Linker, and Librarian on a standard 386-based personal computer using the SCO 
UNIX System V/386 operating system. 


The operating system prompt used in the directions is a percent sign (%). Your 
system may be configured with a different prompt. 


Distribution Format 


The ASM68K assembler package for the SCO UNIX System V operating system is 
distributed on 5.25 inch (360K or 1.2MB) or 3.5 inch (720K or 1.4MB) floppy 
diskettes in a UNIX tar format that is readable by the SCO UNIX custom 
installation program. 


installation Procedure 


To install the ASM68K files, complete the following steps: 


1. Log in to an account that has super-user privileges. Since ASM68K files 
will be copied to directories requiring root write permission, you must have 
super-user privileges to complete the installation. 


2. Run the custom installation program by entering: 
% custom -m /dev/XXxxX 


where xxxx is the device name. Refer to the system file /etc/default/tar for 
your device name. 


For more information on custom, a menu-driven program that is resident on 
your SCO UNIX system, refer to the SCO UNIX System Administrator’ s 
Reference Manual. 


3. Add /usr/mri/bin to your path variable if it is not already there. If you are 
using the C shell (csh), enter: 


% set path=($path /usr/mri/bin) 
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If you are using the Bourne shell (sh), enter: 
% PATH@"S$PATH:/usr/mri/bin" 
4, Change your .login (csh) or .profile (sh) file to include /usr/mri/bin in 
your path definition. 


5. If you are using the C shell (csh), you must make executable files available 
from the current directory by entering: 


% rehash 


You have now completed the ASM68K installation. 


Getting Started 


After installation, see the Microtec Research ASM68K User's Guide for 
information on how to invoke ASM68K. 
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Reader's Response 


Please complete and retum the following Reader's Response form to help 
us improve our documentation. Your comments and suggestions are 


always appreciated. 

Product Name Manual Date/Version 
Your Name Title 
Company. Address 
Phone Number 
What ts your level of programming experience? In this language? 

Advanced Advanced 

Intermediate Intermediate 

Beginner Beginner 
Circle the number which best expresses your rating of the Information In this manuat (5 is the highest rating): 
Complete? 1 2 3 4 5 Easy to understand? 1 2 3 4 5 
Accurate? 1 2 3 4 5 Helpful examples? 1 2 3 4 5 
Wellorganized? 1 2 3 4 5 Helpful procedures? 1 2 3 4 5 
EasytoFind? 1 2 3 4 § At an appropriate tevel? = 1 2 3 4 5 
EasytoRead? 1 2 3 4 5 Overall rating? 1 2 3 4 5 


3.} Which programming language do you use? 


4.) Does the manual provide all the necessary information? If not, what Is missing? 


5.) Are more examples needed? if so, where? 


6.) Did you have any difficulty understanding descriptions or wording? If so, where? 


7.) Which sections of this manual are the most important? The most helpful? F 


8.) What are the best features of this manual? 


9.) What are the areas in this manual that need improvement? 


10.) Did you find any errors in this manual? (Specify section and page number.) 


SD 


_ Software Performance Report Instructions 


If problems or errors are encountered when using Microtec Research’s software products (includ- 
ing documentation), a Software Performance Report (SPR) should be completed and returned to: 


Microtec Research 
Software Performance Reports 
2350 Mission College Boulevard 
Santa Clara, CA 95054 


Any comments of suggestions you may have should also be included. All SPRs are directed to our 
Technical Support Department for analysis and response. 


When completing the top section of the SPR, enter the following: 


1. 


a. 


30.00 SE GN 


Product name and Version number as it appears on the media label or the banner that 
appears on the screen when the product is invoked. 


Serial Number as it appears on the media label. 

Name of the person (Customer) that Microtec Research can contact. 
Name of the company that the software was Purchased From. 
Company Name and a shipping Address. 

Phone Number and/or FAX Number of contact name. 

Host (machine where the Microtec Research product is run). 

Host Operating System and Version Number. 

Report Type showing the type of problem reported. 


10. Customer Impact indicating the severity of the problem. 


- The following guidelines should be followed when completing the bottom section of the SPR: 


1, 


2. 
3. 


4. 


Give as complete a description as possible of the problem, exror, or suggestion, 
including the exact wording of any error messages. 

If possible, isolate the problem by providing a small example. 

If the error example is longer than one page of source code, send all information on a 
tape or floppy disk. 

Carefully label any media you send and indicate whether you want it retuned to yon. 


Include command files, listings, load maps, include files, data files, and all other 
relevant material with the SPR. 


If applicable, send sample input and output listings. 


7. If the output is from a compiler, send a mixed (source/assembly code) listing. 


| If the information on the SPR is complete and concise, it will help us give you accurate and timely 
service to any software problem. 
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Software Performance Report 


Customer: 
Company Name/Address 


Product: 


Version: 


Serial Number: 


Phones Number 


Purchased From: 


Host: [ } Apotio { ] HP [}]PC [ ] Other 
[}Sun3 | [ ]Sun-4/SPARC [] VMS 
Operating System Version 
Report Type: Customer Impact: 
[ ] ProblervError [ ] Heavy 
[ ] Documentation | ] Moderate 
[ ] Feature Request [ ] Minor 
[ } Other 


Problem Description (Attach additional pages if needed): 


Problem Recreation (Commands or lines of code used to duplicate problem): 


Workaround (Attach additional pages it needed): 


Yi Microtec 
Research Inc. 


2350 Mission College Blvd. 
Santa Clara, CA 95054 

Tel. 408.980.1300 

Toll Free 800.950.5554 
FAX 408.982.8266 


